Crate motore

Overview

Motore is a library of the basic abstractions of middlewares for building robust networking clients and servers.

Motore is greatly inspired by the tower crate, and we have used / modified some of Tower’s code and documentation. We really appreciate the work that the Tower team have done.

Tower is licensed under the MIT license, and a copy can be found under the licenses/tower directory.

Motore provides a simple core abstraction, the Service trait, which represents an asynchronous function taking a request and returning either a response or an error. This abstraction can be used to model both clients and servers.

Generic components, like timeouts, rate limiting, and load balancing, can be modeled as Services that wrap some inner service and apply additional behavior before or after the inner service is called. This allows implementing these components in a protocol-agnostic, composable way. Typically, such services are referred to as middleware.

An additional abstraction, the Layer trait, is used to compose middleware with Services. If a Service can be thought of as an asynchronous function from a request type to a response type, a Layer is a function taking a Service of one type and returning a Service of a different type. The ServiceBuilder type is used to add middleware to a service by composing it with multiple Layers.

Re-exports

• pub use service::BoxCloneService;
• pub use service::Service;
• pub use service::ServiceExt;
• pub use service::UnaryService;

Modules

• builder
  Builder types to compose layers and services
• layer
  Layer traits and extensions.
• make
  Pre-defined Service traits that may be useful for specified use cases.
• service
  Definition of the core Service trait to Motore.
• timeout
  Applies a timeout to request if the inner service’s call does not complete within specified timeout, the response will be aborted.
• utils

Type Aliases

• BoxError
  Alias for a type-erased error type.

Attribute Macros

• service
  This macro can help you to write a Service in a more efficient way.